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INTRODUCTION 


GENERAL 


The 8500 Interpreter Environment Program CIEP) ts used to 
establish an environment for the 8500 Interpreter since the 8500 
Interpreter requires an environment file that describes’ the 
memory sizes peripheral configuration and special options of the 


target 86500 environmente Establishing an environment file 
parallels the compilation of a programming Language except that 
there is no source code read nor object code produced. The 


BSOO/IEP accepts free format specifications and uses default 


characteristics wherever possible. The environment file» when 


written to B1800/B1700 disk» may be used for 8500 interpretation 
until the configuration of the 8500 system changes» and then the 
environment file must be recompiled» or modified. 


After. the environment is established» the environment file is 


executed to start 8500 interpretation. The execution phase 1s 
discussed in another product specification» 8500 Interpreter 
CP.S. 2212 5348). This product specification describes the 
compilation phase and the requirements of the interface to the 
execution phase. The discussion is supplemented with examples 
and an appendixe The alphabetic index references the major 
components of this programe 


> one CRED <a aE eee aa <n a 


RELATED PUBLICATIONS 


’ 


Name. 2 ee - Number. 


B500 Interpreter 3 P.Se 2212 5348 


81800/81700 Software Operational Guide 1068731 
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SYNTAX DEFINITIONS 


BSOO/TIEP | instructions are displayed through railroad syntax 


diagrams» §§a concise method of explaining syntax that involves 
defaults» alternatives» and iterations. The basic rule of this. 
method is that any path traced along the forward directions of 
the arrows will produce a syntactically valid command. | 


BSOO/IEP instructions are constructed of letters» digits» special 


characters and blanks. Alphanumeric characters may be separated 


into such items are integers» keywords and identifiers. 


Upper-case letters in syntax diagrams indicate keywords which 
must appear Literalty in the command. | | 3 


ER CRED CEES EE ETD 


Blanks in 8500/IEP commands serve to separate syntactic items and 


may appear freely except within certain text fields» where they 
become significant characters. Whenever one alphanumeric ites 
(keywords identifiers integers» etce) follows another» they must 


be separated by at least one blank. 


SYNTACTIC VARTABLES 


Lowercase Letters» words and phrases that occur within broken 
brackets (<>) are syntactic variables» and these variables 


represent information to be supplied by the user. A particular 


variable may require a single character (Ceege»s <letter>)» a 


Simple construct such as an integer or text string Ceege» EOS = 


~—9<an>)> or a relatively complicated construct. Ceege» 


<diskename>)e The basic variables used tin B500 IEP syntax are 
defined as 


<number> A positive integer. 


<digit> A positive integer Detween zero and F. 


ove 
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<character> © Abbreviated as <char>. 


<name> A textual string consisting of? one to ten 


characters» no imbedded blanks» beginning 


with an alphabetic character. 


<packtid> | A <name>» iseer from one to ten characters 


with no imbedded blanks. 


<multifile“id> A <name>»s ieee» from one to ten characters 


with no imbedded btanks. Abbreviated as 
<mfid>. = 
<fite~id> A <name>s ie@e» from one to ten characters 


with no imbedded blanks. 


<diskename> From one to three <name>s» consisting of a 
| <name>» a <mfid>/<name>» a <pack™1id>/<mfid>/ 
or a <packtid>/<mfid>/<fileid>. The tera 

can be defined through railroad syntax as: 


ee ee ee aw mann ema men ae ma oe <name> Sse == see e nn manaman=> fi 
=; i : i 
{ t-- <mfid>/ -->1- 
i } | | 
[esse eer= <pacCk" 1 Gos Cal ides Seer ees Steer seers ee st See sere => yh 
| | 4 | 
{ | | tern <filetid> --->i 


Figure 2.1 Sample Syntactic Variable 
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ENVIRONMENT: QEFINED 


The environment file is created by specifying the memory size and 


peripherals that the 8500 Interpreter will use to process data in 


the target environmente As the syntax will shows each 
specification contains required and optionat entries. When a 
device specification is omitted» it is assumed that the 
corresponding device witl not be part o f the emulated 
environment. If a device specification does not define all of 
the possible characteristics of the device» the I€P will use 


default characteristics appropriate for that device. Defaults 
are specified for each device. 


MEMORY SIZE 


This statement specifies the amount of memory to be included in 
the emulated environment. This statement is required in every 
environment specification. 


Syntax: | 


MEMORY.S [ZE teen c cen nen n enna -n---- 4.286K 2a aa ; ooawen > Z 
| | . 4 
Pom = mdf beeenesn9= 9.6K sone enenn>] 
{ 
(prmererr$ 19.2K eceennnn- >I 
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CARD READER 


This statement specifies that a card reader with the described 
attributes is to be included in the environment. 


Syntax: 


CARD-READER Leena S Sass as en one SSS SSS Seer as ee Ss teers «7 -=>f# 
| (omen een we nn nnn nn nnn nn en ee ene enna w-n--| 


{-- NAME i a a a <filerid> om]. 


i { ae | 1 i 
per = om d to ! 
' | I-- <mfid>/ ~-->1 | 1 
7 a , , ' 
b-- PACK.ID stereeteserere* <packtid> crete rrte2">] 
pi 1 ' 
b-- PID----->1 tne = =>] | ! 
| | | | 4 
b-- DEVICE cee nmnnnn--= CARD. READER@- nA - A= 2--> I 

7 i 1 1 4 

tee a Sse) f= CRD Se errrot 

| | i { 
fe" DISK s---- >] 
| 
=o (0S erses> >I 


Semantics: 


The default name is 8500.CARDS and may be changed by the NAME 
attribute. : | : | 
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EV 


- This statement specifies that the disk named in the specification 
: with the described attributes is to be included in the 
| environment. | | | 


Syntax: 


EU<digit> at ul sao ee sa fs Sn sneer eae hew ? o> eg 


i : | ( 
| ¢<e ewe ewaerweana ? SNORE aD ana as annanweama | 
| { | 1 
| | {-- NA ME enw sana annnannanmene= ¢<diskename> owewe > | 
: 2 | i | { 
j _ {j-- = ~“=>{ { 

a : | | I 
j-- NEW eon ne Re ewe ete eee Bones sae wee oe ae» | 


i--. OLD Se eeeeeses =a [SS tse5 ssn esse eee a sae 


(Pet LOCK cence nnn nnn nnn cnn nce eens nnnnn ence nena ->1 
i | 
(Per PACK.ID s-eeeen-- ercen=- <packtid> --"°--- --->] 
4 : ! | 4 
| I=- = =>] | | ! 


{ i 
I-- BUFFERS secret errer--- <number from 1 to 15> -=->1 
{ i an 4. 
: _ p= 2. =>] 3 | ft 


Semantics: 


The default name is 8500/EU<digit>» and no two EUs are allowed to. 
have the same <diskename>. NEW specifies that the EU does not 
exist on the B1800/B81700 disk ore if one exists» it is not to be 
usede OLD specifies that the EU exists on the 81800/81700 disk. 
OLD is default. LOCK specifies that the EU is to be saved in the 
| 7  B1800/B81700 Disk Directory at the end of the interpretation run 
Z amd any old EU wilt be replaced- §$-LOCK is reset by default. 
| PACK.e.ID allows the EU to be placed on a user pack or cartridge. 
The default is system disk. | 


BUFFERS OPTION 
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The BUFFERS option allows users to optimize the speed of their 
disk accesses. Since all types of EU's are RANDOM to the 
Interpreters it cannot take advantage of buffer usages’ for 
sequentiat or serial files. As of the Mark VI.1i releaser the 
Interpreter will take advantage of DELAYED.RANDOM> a new disk 
access method. WHEN DELAYED.RANODOM is used» blocks are only 
Written to disk Can actual I/70) when the buffer is required for 
storage of a different block. In the originad implementation of 
RANDOM access» an [/0 was initiated whenever the Interpreter 
performed a WRITE communicate. 


The number of buffers assigned by the MCP to each virtual disk 
file is dynamically left up to the user. The default is only one 
buf fer» but the user may specify up to fifteen. It 1s not 
necessarily true that a program will run faster if more buffers 
are allocated; but» depending on the type of disk activity» an 
additional buffer may make substantial amounts of improvement. 
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TAPE 


This statement specifies that the tape drive named tn the 
specification with the described attributes is to be included in 


the environment. 


l-- TAPE.9 son---"->1 
I-- TAPE.PE -o----->1 


syntax: 

TAPE 1 sect cee emer meme nee em ee mm enn ne meena seen emma meena aa sig 

TAPE2 =~>1! 1 : 4 

TAPE3 *->1 Cee SS pt ee ee ee ee ee oe 

TAPE4 ->]1 } | | j 

TAPES -=7>1 fromm UNIT NAME ee eorowrrertor= MI<letteroer7er"">] 

TAPE6 “7>1 i | § 7 a i 7 | j 
i j . (== =] Fe) i 
i ‘a | | | } 
i T=" DEVICE “-=s=eee+-+< Sees Are, Aes ees ed 
{ e= f=. 98s) ("TAP Ae s=-= >I 
| 
i 


Semantics: 


UNIT.~NAME specifies that the 81800/81700 unit named is to be used 
for the specified 8B500 tape unite UNITse«NAME is unassigned by 
default and the first time the 8500 unit its accessed the operator 
will be requested to assign a unit to the 8500 environment. 
DEVICE spectfies the type of hardware to be used for this unit. 
The DEVICE default is TAPE.7. | | | 
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PRINTER 

This statement specifies” that the printer named in the 


specification with the described attributes is to be included in 
the environmente | | 3 


syntax: 
PRINTER ete See eae ee Seer ee eee ee eee ee ees See S - »% 
PRINTER2 <-->! 3 _ 1 
7 | <e ec owesee ees 50 See See eens see anse=e@ 2 om om mn ae om i 
i 7 | 1 
(7= ‘POSE LUNS. 222 sr ee ees ss Se Set de ee ->!1 
i de Se Wee SZ. eSeeee >I 
: | ; 


I“ HARDWARE -onsen ee nee nnn nnn n ne nnnnenn---- >I 
i | | 7 L 
Joo BACKUP women ne mene ne nnn en nnn nnn ene - nee “=>! 
1-- BACKUP. DISK see een en nn nen n nnn nnen nnn n--->} 
' | | 4 


I-- BACKUP. TAPE won ee nnn n nnn enn nn ennnenenen- >I 
\ 7 | | _ 3 3 1 
b-— FORMS sac cen ncn ne nnn nen nec nc cence cnnnn=->{ 
i | | i 
I-- LABELS TYPE steno nc nn nce nsnncneneccnen= >I 
i t-- = <=>1 Jo STANDARD --->! 
4 I-~ UNLABELED ~~->! 
j _ 4 
I-- UNIT.NAME so--------- LP<letter> ------->1 

: t | 

t-- = sat 


Semantics: 


POSITIONS specifies the number of print positions of the printer 


to be used. lf 132 positions are requested and the file is sent 
to a printer with only 120 positions» the Last 12 positions will 
be lost. 132 is the default. HAROWARE specifies that the file 


is to go to a physical printer is possible. HARDWARE is true by 


default. BACKUP will set BACKUP.DISK and BACKUP.TAPE. 


~BACKUP.DISK specifies that the file is to go to BACKUP on disk if 


a printer is not available. BACKUP.TAPE specifies that the file 


is to go to backup on tape is a printer is not available. | 
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BACKUPeDISK and BACKUP.TAPE are false by default. FORMS 


specifies the printer is to be Loaded with special forms and will 
not start printing until the operator loads the forms. FORMS is 
false by default. | | | 


ea bhsiet esters 
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PUNCH 

This statement specifies that a punch with the described 


attributes ts to be tncluded itn the environment. 


Syntax: 


PUNCH ssseesse------ a ialetatatatatatetatetatetatatate slatatatatetaietaiatananatatetaatatanateteatate ># 
ala lalalatatalatetatatatalatalatatatatatata te lia Dalaletataatalalelatetatatatatataaatetarene 
| = ' 
[o~ NAME cron e renee en en ene nwennen= <name> concer enn >I 

4 I-“- = ==>] 
. ! 
PescPACKs10 eatsseeasesmsseomessa <packsid> wn nn--->| 


t i (<= SS 
l-- PID ------>1 | | 
i a | | ! 
i= DEVICE. HoSseses-Ss25-s> woo-=-= CARDsPUNCH ==""">1 
i | [=< = Sef 16S. CPC esarss<en== >1 
i | : | i-- DISK s--------- >| 
{ (== 0S =se4ses=<4> >4 
I a | i 
Pos: UNI VeNANE see esesrese seen === CP<Letter> =7es- >I 


Im- = =>) Im~ CO<tletter> ----">1 


semantics: 


The default NAME is 8500.CARDS and may be changed by the NAME 
attribute. The remaining attributes are the same as for the 
orintere — | | | 


If a PACK.eID is specified through "PACK. ID" or “NAME* and ODEVICE 
is not set to DISK» a warning will be issued- NAME may include 
PACK.ID. © | : 
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The optional declarations allowed in a 8BS500 environment are 
declared as follows: 8 | 


| <2 ee cen enmoen senate en 5 ANE RAAT ae wna anaawe | 
I-- AUTO.LOAD woe rnrnnnnnnn---- eneon------- woeero---- ---->1 


; | | | | | 
1 _ a 
q -— = LOAD-e-READER AOR EDAD EDAEKEODKMODBDanDaAeananae sie aia aes mm 1 a 2 an omamanw> | 
i I-- NAME soeeenennmernn <diskename> "“ "7" >i ot 
7 en eels oe | 4 
{ L 
l-= PID --=>1 I-- = -=>1 
{ | i 


[o> DEVICE se---ses------ CARDeREALER -">1 
Jen = 29>b bee CRD cere neenen>l 


an me in a te an aa mn a on oa a 


i 

| | 

(== PACKs ID Se eerserser= <pack=td> <=2s">1 1 

i 

f 

I 

== DISK Seess=SeF>t 4 

[=="0SK -====- =“e==>f 1 

5 | | : | * a8. a | j 
-~ TAPE.BUFFER.SIZE ster eter tn nennn= <number sat ees errr=-- >I 
- i-- = =->1 an | 

| 7 | _ - 4 

P= SETSSENSESSWIICHES. “Serre eeseesesce=e= <switches> ------ >I 
ies SSWes<=2s= Sesaseerse> | ft Si est | ' 
oo | 
j-S TRACE (= =Sese7= Sevres > ON Hee nase sSSSesee ssa sera sere > | 
i - | j==~=. DFP ==S=>) : 
| | i 
t [ <SSeeestenisencsesseeeasesscneseneseeess=|- I 
i , 8 Wgeeee. 5. oes =4 ee 
1 | 1 e fo 
Pe] TAPESRETRIES: JaSS9Re= READ: Soseesees sre s< ON. sse<=<5 >>! 
i i | p=SSoe> Of <==s+s > of 
I i | . i ot 
1 4 | oo | if 
i [eesceeo WRITE -oesatees 2e6= ON 2eceess >i 4 
' ; posesee OFF e=S=s—>1 | 
t i 
C24 EUs Seer res rere esos Veen SS eeseere eres 772422 e=SS oe A 
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If a PACK.ID is specified through "PACK.ID" or "NAME" and device 
is not set to DISK» a warning will be issued. "NAME" may now 
include PACK.ID. | , 


TAPE.-BUFFER.SIZE is the physical size of the users tape buffer. 
It should be slightly larger than the Largest tape record that 
will be read. Note» the size is given in “characters” and 
automatically “adjusts” to the tape type. The maximum speci fied 
number of characters should not exceed the specified MEMORY.SIZE. 
Notes» also that space will not be generated for this buffer 
unless at least .one unit is declared. 


SETeSENSE.~SWITCHES allows the user to set particular sense 
Switches at BOJ time. The variables <switches> must be sense 
switch numbers 1 through 6. Any or all of them may be specified 
and will be sete. If they are not specified» they wild be reset. 
The switch numbers must not have blanks or commas between them. 
For example» "SSW 1465" sets switches 1» 4» and 6- | 


TRACE causes the interpreter to begin tracing code from BOJ time. 


TAPESRETRIES option witt cause the 8500 Interpreter to do. 
standard automatic read/write tape retry operations. 


EX: | | 
TAPE eSRETRIES READ ON WRITE OFF; 
or TAPE.RETRIES READ ONs 


will cause tape read retries to occur but not tape write retries. 


If TAPEsRETRIES is not specified» then responsibility for. 
read/write tape retry operations is Left up to the user program. 


E0J option will cause the 8500 Interpreter to terminate the 8500 
virtual machine in a normal fashion. If EQS has been specified» 
and the 8500 virtual machine executes a halt machine instruction 
(9<mn>)>» the <mn> variants of the halt instruction are compared 
to the <mn> variants of the optional EQJ specification. If the 
variants are equal» the B81800/B1700 job will terminate. 


Note: <mn> can consist of any Legal 8500 character. 


hot 
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COMPILATION 


The S8500/IEP creates an environment file using a standard 
B1800/B1700 compile deck to specify the options desired by’ the 
USeT « Normally» this deck includes the following cards: 
compiles label Cwith Label equation)» data and end. This section 
lists and explains the various options that can be selected 
through a BSO00/IEP compile decks A sample deck is shown in 
Figure Sel. | | | a 


COMPILE 


The compile card is normatly the first card in the deck. If it 
is not includeds the operator wittl have to enter the compile 
statement from the SPO. The options available are as follows: 


OPTION | | INSTRUCTION 


1. Compile and go PCOMPILE program=name WITH BSOO/IEP | 

22 Compile for syntax 2COMPILE progras=name WITH BSOO/IEP SYNTAX. 
3-2 Compile to library 2COMPILE program=name WITH BSOO/IEP LIBRARY 
4. Compile/go» Library 2COMPILE program~name WITH BSOO/IEP SAVE 


Note: COMPILE may be abbreviated C0; WITH is optional. 


LABEL EQUATION CARD 


In order to avoid duplicate file names» the Label equation card 
9s used» especially when operating in a multi-programming 
environment. The format of the label equation card is the 
following: | os 7 


27FILE <internatcfile-name><file attributesr»e «. «3 


If used» the label equation card must preceed the MCP Label 
control card. Refer to Figure 5.1. : 


Aw? 
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The internal file-names and external fitetid's used by the 
BSOO/IEP program are as follows: 


INTERNAL EXTERNAL DESCRIPTION 


FILE-NAME FILE-I00 00 teen ena 
CARDS CARDS Input file from the card 


readere The default ins 
put is from the card 
readere 


LINE | LINE , Source output Listing to 
| the line printer. 


CODE | CODE Result and codefile will 
| 7 be renamed from the com 
pile card. 7 


To compile an environment program from a disk file with the 


filerid of "TEST2"» use the following deck: 


COMPILE 8500 WITH B500/IEP TO LIBRARY 
FI CARDS NAME TEST2 DISK DEFAULTs— 


i 2?FI CARDS NAME Lees DISK DEF AULT> 


; / ws an an on on owe S eee ee ee ee aa am unanw a e =m am 27 non oe oe on on oe 


1°? CO 8500 WITH BSOO/IEP TO LIBRARY 
j 


Figure 4-1 Sample Compile Deck 
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MCP LABEL CARD 
The MCP label card is formatted as follows: 


2 DATA CARDS 


The card indicates EBCDIC source Language input. 


following message will be displayed on the SPO: 


If absent» the. 


**N0 FILE<f ile~name><program=name? = <j ob-number> 


Without specific instructions from the programmers the operator will 


not know the proper IL message to give the MCP. 


GPTIONAL SPO INPUT 


ED AR CU ET GEE CED ERED CED EE an eqn Ee <TD 


Since the 8500 IEP is a program that 1S run infrequently» and 
because it is necessary to have a one time special environment 


occassionally» an optional SPO input instead of 


card 


available for 3500 specifications by setting SWO=1. 


SAMPLE ENVIRONMENT SPECIFICATIONS 


SAVE 


SYNTAX 


2° C0 <program name> WITH B500/IEP swo=t ( LIBRAR 


input 1s 


> 


If a 8500 Interpreter environment catted "BSOO/TEST®™ is desired> 


dl 


the following characteristics are specified in 
environment: 7 Se 


1) 926K memory 
2) 132-character orinter Cprinter 1) 


3d A card punch 


the 


Interpreter | 
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4) If we execute a 999 halt at end-of-progran, we want to 
pontruce Paece neta 7 | | 


In order to create an environment with these characteristics» the 
following cards. should be used: 


[ Pees ewe me ew ew ee mene eee meee mee eee ae 
i ?END 
| ioaatettetetatatetetetalatetatetatatatatahatetatatatatatetetataaeteteaten 
1 FINI ; 
fo=- Sw Basen annanne <2 om GD an OF aD om ae an oD aD an a on a ee = 
t EQS = 9993 
[ Sacer nammacaamnonmane ee SS 


[| CARD.~PUNCH >» 


[awe eee e nw wn ween we ew eee com eeenne om a 4b ab Gb ab a 4 @ 


{4 PRINTER? POSITIONS = 132 >» 


f seer cece wee aceon ee ee ween eae n ema aemn ew emeeeoe 


1 MEMORY.SIZE 926K 3 


{1 2DATA CARDS 


{1 27COMPILE B500/TEST WITH BSOO/IEP TO LI 5 
1 | 


Figure 4e3 Sample IEP Deck 
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EMULATOR 1720 


In order to maintain conststency with MCP conventions and the 
philosophy behind them» att 8500 peripherals are mapped onto 
existing file structures- In this fashion» MCP functions such as 
backup files» pseudo readers»s and file equate ae are 
realized BY emulators without significant problems. 


Using file structures also enables the Interpreter to delay the 
binding of hardware until it is accesseds ieee» although an 
Interpreter may require two card readerss if they are never used 
at the same time during emulations they may both be emulated by 
the same card readere If a device is accessed while it is busy» 
either on the same Interpreter or on a native B1800/B1700 mode 
programs the Interpreter will wait for the FILE card before. 
continuing and» therefore» eliminates the problems of run time 
contention for devices. | | : 


The Run Structure is created by the MCP at BOJ timee Various 


fields or parameters are read from the PPB into the Run 
Structure. The Interpreter can thereby initialize the hardware 


scratchpad registers with data peasee to it from the environnent 
created by the BSOO/IEP. 

SLA 

8500. INDICATORS 

FILLER BITC16) | Must be zero 


SENSE.SWITCH BITC6) May be set or reset 
FILLER  BITC2) Must be zero 
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DESCRIPTOR INTERFACE 


The PERIPHERAL-DESCRIPTOR is the major interface component 
between the 8500 Interpreter and the 8500 Interpreter Environment 
Program CIEP). The IEP as responsible for creating the 247bit 
descriptor and passing it to the tnterpreter in the Program 
Parameter Block. | | 


The PERIPHERAL-DESCRIPTOR defines the peripheral environment of 
the 8500 described by the environment file in which it 1s 
contained-and its format is shown below. A bit ON indicates that 
the corresponding device is in the environments OFF indicates 
that it its note | | 


518 


PERIPHERAL. DESCRIPTOR 


BIT # Cfrom left) 
CARDeREADER ceo vcvccecaccesves 0 
PRINTERIL eoccccrencaeneccere 1 
PRINTER2 cconncccesececcecce 2 | 
PUNCH cuacccasccaeseneeevese 3 A File Parameter Block CFPB) 
O1SKe0 226566 40seseeseeseee 4 for each of the devices 
DISK e-1 evaccccscevsrensevenees 29 referenced mn the 
* ac ccccccccesenscsces 6 PERIPHERAL-DESCRIPTOR.} They 
5: ace a enahave Gea e@wve.e wales 7 will exist in the name order» 
ec ec aneeneeveeeneeeeene 8 as well. 
esa een ean ne02nen 2 8eene2 82808280 9 . 
eo ee2eneannnaneneen eve eee, 10. 
oe seeenvannenerseaneveaene0 11 
. . e ee2ecensenenananenennaenen 12 
DISK ee wspenvenenezseseecencanee 13 
TAPE el moneessnesnecereneaeneee 14 
TAPE <2? wc ccevreseesvessnesenes 15 
-) rere rrr eT Te eT Le ee ee 16 
oe esceesrnenanneeneanenee 17 
° ee er eee ee ee ee ee 18 


TAPE 06 coccccecccccevcceses 19 
LOAD-FILE rrr errrrrerrrrret sy 20 
<FREE> eaeaeneaanneneonn0en en e202 eon 0208 21723 


2A 


TARGET.MEMORY BASE — pITc24) 
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$28 


STATIC. MEMORY «SIZE BITC24) 


2ZA 
EU. DENSITY. INDICATORS 
DOUBLE.~DENSITY~ INDICATORS BITC10) | 
~er> TRUE = DOUBLE DENSITY 
S4A 
: EQU. 9XX a BIT(24) | 
- | “--> Contains “9mn"» where “mn" 
are two characters which 
represent the “m" and “n" 
variants of a halt 
descriptione 
\ 
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Valid instructions for the 8500 IEP program are presented in 
railroad~syntax diagrams» — a method which altows visual 


representatton of syntactic units. A B500 IEP instruction is 


constructed by following the main line of development from its 
beginning (>) to its point of termination (#). Where optional 
entries are concerneds the direction of flow proceeds down on the. 
left~hand line and up on the right. Unless otherwise noted» 
optional entries are expected by the program tn the crder (top to 
bottom) tin which they are presented. | 


Required entries occur on the main Line of developments optional 


ones below the Line. Required keywords appear in upper-case 
letters; variables in lowercase letters. Underlined portions 
of required keywords are acceptable abbreviations for the 
keywordse In the example of railroad syntax given in figure 6els. 
the following conditions are implied: ; 


The main tine of development is from left to right» down 
on the left vertical line and up on the righte A loop or 
series of choices is shown by a return line with an arrow 
showing a flow to the Left (<eesese"---). | 


t An arrow shows the direction of progress from the point 
of origination (>*-") to termination (C#). A statement is 
not complete until it reaches a terminator (C#)- Where 


the syntax continues on another line» a double arrow (>>) 
is used» both to break the first Line and to continue me 
seconde The continuation Pome is indented. 


* Required syntax is presented on the main Line of 
developments  optionat on a secondary Lines. Required 
keywords are presented in capital letters; variables in 
Lower casee Underlined portions of Reveord> are their 
allowable abbreviationse | | 


* The bridge /n\ shows the maximum number of times the Line 
may be crossede The bridge /n*\ shows that the line must 
be crossed at teast oncee Since required syntax 15s 
usually shown on the main Line of development» the J/n*®N 
options presumably» will not need to be used often. 


* Abbreviations may be used for variables. A list of 
standard abbreviations may be presented in the 
introduction of the document or the List may immediately 
precede the figure- In either case» the abbreviation(s) 
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should be as obvious as possible. 


Angle brackets (<>) and a Space occur around variables; 
a space precedes and follows a required word. : 


The pound sign (#) denotes a termination point for the 
syntax of the item being described. 


Conttnuation of a primary or secondary tine of 
development can also be shown by a continuous line that. 
returns (<errr"""") and then flows forward (eeerrere--->) 
to a vertical tine. The return tine may contain an 
entry. This format is helpful when an optional parameter 
contains several elements itself. 


A horizontal line between entries must be represented by 
at least a dash (--) tn order to clearly distinguish the 
Line from a hyphenated worde , ) | 
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>= 
>=" 


PFM ~<-=>| 
COPY --->1 


Ii-- <routinestype> ~->1 


673 


TAL. 
IEP 
CB) 


I“J1Ne" <inputerec-tgth> wm nn nn nn en nn nn re nnn nn nnn ernn= >t 


I-- <blocking-factor> -~>! 


I=/1\ =" TAGS <tagrfilerid> rrecreer eerste r nnn r nnn nnn nn 


b-71\-- <input-file~access7mode> saeinnnaeesqieessserersse> 1 
I“/1\-— <output-filerid> commer eee netenn ten nn eran crn nnn n>! 


I-/1N\errrrn= <outputmrecwlgth> ~-"-----9>> 


1<---- <blocks*percarea> “7-7! 


I“/1\-°° <output°file~access*mode> ster etter errr rernn>t 


P"J1N9= VARIABLE comer meen enn crew n meen sentence nen nenennn>] 


l | 
PST 1\ r= 
4 
es 

i 
: 


VARY 2=">!1 


SEARCH *- <start-posn> --7- 


SELECT ---- <start*posn> =" <searchtarg> w7777"7>1 


{ 
EXCLUDE =->1 


I-/1\-- SKIP <integer> coors oer erent nme n etn r rr ntrt tran n 


I-- <nume*totmreturn> “77> I 


KEY =" <start-posn> s7°°777" wae ewe eee ewenn 


jim-- <keywlgth> “<-->! i 
| j 


i-- <num@tovreturn> 77>] 


Figure 6-1 Sample of Raitroad Syntax. 
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<searchwarg> we37"-">1 
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BLANKS 2-1 
CARD READER 372 

COMPILATION 4-21 

COMPILE 4-1 

DESCRIPTOR INTERFACE 572 
EMULATOR I/0 5-1 | 
ENVIRONMENT: DEFINED 3-1 

EU 3-3 - oe 
EXAMPLE: LABEL EQUATION 4-2 
GENERAL 1-1 

INTRODUCTION. 1-1 

KEYWORDS 2-1 

LABEL EQUATION CARD 4-1 

MCP LABEL CARD 4-3 

MEMORY SIZE 3-1 

OPTIONAL DECLARATIONS 379 
OPTIONAL SPO INPUT 473 

PPB INTERFACE TO THE INTERPRETER 
PRINTER 376 

PUNCH 378 | 
RELATED PUBLICATIONS 1-1 
SAMPLE ENVIRONMENT SPECIFICATIONS 
SYNTACTIC VARIABLES 271 
SYNTAX DEFINITIONS 271 
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